home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / comm / zip152.zip / ZIP.DOC < prev    next >
Text File  |  1992-06-05  |  36KB  |  705 lines

  1.  
  2.                                    ZIP.DOC
  3.                                    -------
  4.                            Instructions for ZIP.COM
  5.                        Fast Serial File Transfer Utility
  6.                          version 1.52 (03 June 1992)
  7.  
  8.                              (c)1988-92 E. Meyer
  9.  
  10.  
  11.         Requires:  two IBM PC compatible computers with DOS 2.x or above;
  12.                    appropriate serial (null modem) cable.
  13.  
  14.  
  15. ================================== CONTENTS ==================================
  16.  
  17.      1. ABOUT ZIP: A brief description; Copyright and Licensing
  18.  
  19.      2. TRANSFERRING FILES
  20.           A. Setting the serial port and speed.
  21.           B. Sending files.
  22.           C. Receiving files.
  23.           D. Selecting files from a group.
  24.           E. Backups and overwriting files.
  25.  
  26.      3. SERVER MODE
  27.           A. Exchanging files.
  28.           B. Viewing directories and deleting files.
  29.  
  30.      4. USAGE EXAMPLES
  31.           A. Using ZIP in batch files.
  32.           B. Examples of command-line syntax.
  33.  
  34.      5. UTILITY PROGRAMS
  35.           A. Using ZIPDUP to clone ZIP.
  36.           B. Using ZIPCFG to change defaults.
  37.  
  38.      6. TECHNICAL INFORMATION
  39.           A. General information.
  40.           B. Using ZIP on the HP95LX palmtop.
  41.           C. Appropriate serial cables.
  42.           D. Error messages.
  43.           E. Version history.
  44.  
  45.  
  46. ================================ 1. ABOUT ZIP ================================
  47.  
  48.  
  49.      Anyone with two computers probably needs to transfer programs or data 
  50. between them regularly... yet if large amounts of data are involved, 
  51. exchanging floppy disks quickly grows tedious; and if the disk drives are 
  52. incompatible, or a portable computer has none, it won't work at all.
  53.  
  54.      ZIP is a tiny, fast utility to transfer files between two IBM compatible 
  55. computers; it requires no expensive additional hardware, just a simple serial 
  56. cable.  It can be used from the DOS command line or a batch file, or run from 
  57. an interactive menu.  Ideal for laptop or palmtop computers, it takes less 
  58. than 10K of disk space, and occupies no memory when not in use.  There are 
  59. good commercial programs for this purpose, though they typically cost over 
  60. $100; if you're willing to find or make your own cable, you can do the same 
  61. job with ZIP instead.  ZIP doesn't have all the features of the fancy 
  62. programs, but then it doesn't consume precious system memory either; it just 
  63. transfers files when you need to, as simply as using the COPY command.  It 
  64. also has options that make reconciling directories on both computers easy.
  65.  
  66.      ZIP is as fast as a serial transfer program can be, and faster than some 
  67. free/shareware programs that also claim to operate "at 115200 bps".  ZIP can 
  68. transfer data up to 6 times faster than an ordinary telecom program over a 
  69. serial cable... 48 times faster than typical modem transfer rates.
  70.             Telecom programs: modem       2400 bps            0.3 K/sec
  71.                               cable      19200 bps            2.3 K/sec
  72.                          ZIP: cable     115200 bps     up to 14.1 K/sec!
  73.      On older PCs and slower portables, ZIP will come as close to this 
  74. throughput as your computers allow.  (Between an 8MHz XT and 4.77MHz laptop, 
  75. it reaches about 10K/sec.)  Of course, disk access also takes time; with any 
  76. system, large amounts of data can be sent more quickly using hard or RAM 
  77. disks, rather than (slow) floppy disk drives.  Although ZIP is designed to 
  78. operate at very high transmission speeds, it can also be used at slower speeds 
  79. in applications that demand this.  (ZIP does NOT work with a modem, however.)
  80.  
  81.      Be sure you have all the files which should be included in this package:
  82.               ZIP.DOC      - This documentation file.
  83.               ZIP.COM      - The ZIP file transfer program.
  84.               ZIPCFG.COM   - The configuration (customizing) utility.
  85.               ZIPDUP.COM   - The duplication (cloning) utility.
  86.               ORDER.FRM    - Registration/site license order form.
  87.  
  88.  
  89.                       COPYRIGHT AND LICENSE INFORMATION
  90.  
  91.          The ZIP program and documentation are copyright (c)1988-92 
  92.          Eric Meyer, all rights reserved worldwide.  They may not be 
  93.          circulated in any incomplete or modified form, nor sold for 
  94.          profit, without written permission of the author.  The use 
  95.          or sale of ZIP is subject to the following terms:
  96.  
  97. SITE LICENSES.  Any company or institution wishing to use ZIP in the course of 
  98.     its business must purchase a SITE LICENSE.  The cost of the license is 
  99.     quite modest, and varies according to the number of computers on which ZIP 
  100.     may be in use in the workplace:
  101.                          COPIES        COST
  102.                        Up to 20  .....  $50 (US)
  103.                              50  ..... $100
  104.                             100  ..... $150
  105.                    200 and over  ..... $1 per copy
  106.     The purchaser of a site license receives several benefits:
  107.             * A copy of the latest version of ZIP on disk direct 
  108.          from the author.  (Specify 5.25" 360k or 3.5" 720k disk.)
  109.             * Support.  You can get help with any questions or 
  110.          problems you encounter in using ZIP.  Future upgrades can 
  111.          be ordered on disk when desired.
  112.             * No piracy worries.  Your employees may use ZIP at home 
  113.          and share it with others at no charge.
  114.  
  115. PERSONAL USE.  There is no required fee for personal use of ZIP.  However, if 
  116.     you like and continue to use ZIP, you are encouraged to register, and help 
  117.     support the development of high-quality, affordable software:
  118.                    INDIVIDUAL REGISTRATION .....  $30 (US)
  119.     The user who chooses to register receives several benefits:
  120.             * A copy of the latest version of ZIP on disk direct 
  121.          from the author.  (Specify 5.25" 360k or 3.5" 720k disk.)
  122.             * Support.  You can get help with any questions or 
  123.          problems you encounter in using ZIP.  Future upgrades can 
  124.          be ordered on disk when desired.
  125.             * A document to verify the legality of your personal use 
  126.          of ZIP at your workplace as well.
  127.  
  128. COMMERCIAL SALE.  Any software dealer or library may offer ZIP for sale, as 
  129.     long as the price charged for the disk containing ZIP does not exceed US 
  130.     $6.  With this single exception, the sale of ZIP, either alone or together 
  131.     with other software or hardware, requires a licensing agreement.  Please 
  132.     write for terms.
  133.  
  134. ORDERING AND SOURCES.  Site licenses and individual registrations may be 
  135.     ordered directly from the author (see address below), by check or money 
  136.     order in US currency; purchase orders are also accepted.
  137.          Credit card orders (VISA,MC,AmEx,Discover), including international, 
  138.     may be made through the Public Software Library: phone (800)242-4775 or 
  139.     (713)524-6394, FAX (713)524-6398, CompuServe [71355,470].  Mention item 
  140.     #10304.  (There is a $5 surcharge for this service.)
  141.          ZIP is distributed widely through "shareware" channels.  Users with a 
  142.     modem can download the latest version as the archive file ZIPxxx.ZIP, 
  143.     available from the primary distribution point: on CompuServe, in download 
  144.     library 4 (DL4) of the IBMCOM forum.
  145.              In addition, ZIP is available on a wide variety of other remote 
  146.     systems, and by mail from many good software libraries, including the 
  147.     Public Software Library, P.O. Box 35705, Houston TX 77235.  (Disk #1674)
  148.  
  149.  
  150.                   Address all correspondence to the author:
  151.  
  152.             Eric Meyer
  153.          3541 Smuggler Way            CompuServe: [74415,1305]
  154.     Boulder, Colorado  80303  USA       Internet: 74415.1305@compuserve.com
  155.  
  156.  
  157.               THE CUSTOMARY DISCLAIMER:  You undertake to use ZIP at 
  158.          your own risk.  The author does not warrant the suitability 
  159.          of ZIP for any particular purpose, and assumes no liability 
  160.          for damages of any kind resulting from its use.
  161.  
  162.  
  163. =========================== 2. TRANSFERRING FILES ============================
  164.  
  165.  
  166.      You will need to have a copy of the same version of ZIP.COM on both 
  167. computers, and the correct cable connection between them.  For more on null 
  168. modem cables, see the Technical Information section below.  If incompatible 
  169. disk formats prevent you from getting ZIP.COM itself onto the second computer 
  170. to begin with, you can "clone" ZIP with the ZIPDUP utility (see below).  If 
  171. you have an HP95LX palmtop, see notes below after USING ZIPCFG.
  172.  
  173.      Transferring a file between computers with ZIP is as easy as copying it 
  174. from one disk to another.  To transfer files, once the cable is properly 
  175. connected to the serial ports of the two computers, from the DOS prompt:
  176.  
  177.            1.  MENU-DRIVEN OPERATION.  Simply type "ZIP" on both 
  178.       machines; the program will offer a menu of choices including 
  179.       transferring or receiving files, viewing file directories and 
  180.       deleting files.  Just type the letter of your selection.
  181.  
  182.            2.  COMMAND-LINE OPERATION, for experienced users.  For a 
  183.       brief help message, type "ZIP /?".  (See full explanations and 
  184.       usage examples, below.)
  185.               zip FILENAME      to send
  186.               zip /R            to receive
  187.               zip /S            to enter server mode
  188.               zip FILENAME /F   to fetch from server
  189.               zip /D[FILENAME]  to get directory from server
  190.               zip /K[FILENAME]  to kill (delete) files on server
  191.  
  192.      As each file is transferred you should see a line of "=" signs, one for 
  193. each 64k of file size; each will turn into a blinking asterisk, then disappear 
  194. as the transfer progresses (the last one leaving a period when finished).
  195.      ZIP can be interrupted and aborted by pressing Escape, ^C, or Ctrl-Break:
  196.           (1) during initial connection attempt
  197.                 (otherwise ZIP waits as long as necessary for connection)
  198.           (2) during file transfer (on sending end, aborts immediately;
  199.                 on receiving end, once current file is finished)
  200.           (3) at confirmation or string input prompts.
  201.  
  202.  
  203. -------------------- A. SETTING THE SERIAL PORT AND SPEED --------------------
  204.  
  205.      IBM-compatible computers have anywhere from one to four serial (RS232) 
  206. ports.  By default ZIP uses the COM1 port.  The standard port addresses are:
  207.                       COM1: 03F8h         COM3:03E8h
  208.                       COM2: 02F8h         COM4:02E8h
  209. Some computers (including PS/2s) use different port addresses for COM3 and 
  210. COM4; to use a nonstandard port address, you must modify ZIP.COM with ZIPCFG.
  211.      You can select any standard COM port during operation of ZIP:  in menu 
  212. mode, just select the choice to modify "P"arameters.  In command-line mode, 
  213. specify one of the following options:
  214.  
  215.               /1-4  = use port COM1-4.
  216.  
  217.      Data transmission can take place at a wide range of speeds.  ZIP normally 
  218. works at the fastest possible speed, 115200 bps.  To accommodate certain 
  219. computers or software environments, it may be necessary to set a somewhat 
  220. slower speed.  In fact, ZIP can be slowed down all the way to 2400 bps, so 
  221. that it can even operate over a good modem connection.  Just be sure you have 
  222. the same rate set on both ends.
  223.      In menu mode, just select the choice to modify "P"arameters.  In command 
  224. line mode, specify the option:
  225.  
  226.               /Bnnnn  = use speed nnnn (BPS)
  227.  
  228. The allowed speeds "nnnn" are 115200, 57600, 38400, 19200, 9600, 4800, 2400; 
  229. each may be abbreviated to as few as two digits ("/B96").  To change the 
  230. default settings, use ZIPCFG.
  231.      You will see a note in the ZIP signon message, "Speed=____ Port=____", 
  232. giving the port address and speed currently in use.
  233.  
  234.  
  235. ------------------------------ B. SENDING FILES ------------------------------
  236.  
  237.      In menu mode, simply select "S"end, and you will be prompted for the 
  238. filename(s).  For command-line use, specify the name(s) of the file(s) to send:
  239.  
  240.               zip FILENAME
  241.  
  242. The "FILENAME" can be a single FILE (including directory), or a GROUP 
  243. specified by wildcards (eg, *.BAK), or an "@FILE" (see below), or a LIST of 
  244. any of these delimited by spaces and/or commas (FILE1,FILE2).  Each item 
  245. assumes or continues the same drive/directory as the previous one (unless the 
  246. new one begins with a drive or root directory).  Thus
  247.  
  248.               C:\WRK>zip b:\sf\gort, ltrs\*.892, klaatu
  249.  
  250. will send files B:\SF\GORT, B:\SF\LTRS\*.892, and B:\SF\LTRS\KLAATU.
  251.      Any desired options may follow the filename(s).  Files will appear with 
  252. the same filename, in the receiving directory.  Take care not to send two 
  253. files with the same name, as one would overwrite the other.
  254.  
  255.      ZIP can also send a group of files whose names are listed IN a file, by 
  256. prefacing that filename with an "@" sign.  A number of file management and 
  257. communications utilities can write a list of filenames selected according to 
  258. various criteria to a file, or accept the name of such a file following an "@" 
  259. sign to process all the names it contains.  You can also create such a file 
  260. yourself, with any text editor, inserting the names of files which you may 
  261. often want to transfer as a group.  Such an "@file" should consist of complete 
  262. filenames (with drive and path), separated by spaces and/or carriage returns.  
  263. ZIP can then be used to transfer those files.  For example,
  264.  
  265.      if file FLIST consists of the names     c:\work\*.bak
  266.                                              c:\myfile
  267.  
  268.      then "ZIP @FLIST" will send files C:\WORK\*.BAK and C:\MYFILE.
  269.  
  270.  
  271. ----------------------------- C. RECEIVING FILES -----------------------------
  272.  
  273.      In menu mode, simply select "R"eceive, and you will be prompted for the 
  274. directory to receive into.  For command-line use, specify the option "/R" for 
  275. RECEIVE:
  276.               zip /R
  277.  
  278. Each file will appear with its original filename.  Files are received into the 
  279. current directory, unless you specify another.  In command-line mode, this can 
  280. be done in square brackets after the /R option:
  281.  
  282.               zip /r[DIRECTORY]
  283.  
  284. Do not supply a filename with the /R option.  (Note: ZIP no longer accepts the 
  285. syntax of earlier versions, where the receive directory was specified from the 
  286. command line by typing "zip DIRECTORY /r", which tended to be confusing.)
  287.  
  288.  
  289. ---------------------- D. SELECTING FILES FROM A GROUP -----------------------
  290.  
  291.      If you want to transfer only certain files in a group (such as *.BAK) 
  292. with ZIP, you can request that you be prompted to confirm each file 
  293. individually: you will be asked to hit a key (Y/N) to determine whether the 
  294. file is to be sent.  (In menu mode, you can select "O"ptions for a help 
  295. message describing the selective copy operations.)  After the names of files 
  296. to be transferred, in menu or command-line mode, specify the option:
  297.  
  298.               /P  = PROMPT to confirm files individually
  299.  
  300.      This option (which can be combined with others) can be specified on 
  301. either end -- but the option on the SENDING (or active) end governs each 
  302. transfer.  You will see a note in the ZIP signon message, "Option /P", if this 
  303. option is in effect.
  304.  
  305.  
  306. ---------------------- E. BACKUPS AND OVERWRITING FILES ----------------------
  307.  
  308.      ZIP offers several options that are especially useful for reconciling the 
  309. contents of directories which are duplicated on both computers.
  310.      It is possible that a file already exists on the receiving end with the 
  311. same name as the one being sent.  By default, ZIP doesn't care: it will 
  312. transfer all files specified, whether or not they overwrite existing ones.  
  313. Several options are provided to modify this behavior.  (In menu mode, you can 
  314. select "O"ptions for a help message describing the selective copy operations.)  
  315. After the names of files to be transferred, in menu or command-line mode, 
  316. specify one (or two) of these options:
  317.  
  318.               /N  = copy NONexisting files only
  319.                        (cannot be used with /E or /T)
  320.               /E  = copy EXISTING files only
  321.               /T  = TIMESTAMP determines files sent
  322.  
  323.      The /N option will prevent existing files from being overwritten.  The /T 
  324. option will allow overwrites only when the new copy has a more recent time 
  325. stamp.  The /ET combination is especially useful for backup purposes: it 
  326. transfers only more recent copies of files that already exist.
  327.      These options can be specified independently on either computer -- but 
  328. the options on the SENDING (or active) end govern each transfer.  You will see 
  329. a note in the ZIP signon message, "Option /_", if an option is in effect.
  330.  
  331.  
  332. =============================== 3. SERVER MODE ===============================
  333.  
  334.  
  335.      It would obviously be easier to transfer files if you could do all the 
  336. typing from one keyboard, and "server mode" lets you do just that.  ZIP can 
  337. stay "on line" on one end, ready to obey instructions from the other end 
  338. automatically.  To enter server mode: in menu mode, just select the choice for 
  339. ser"V"er.  In command line mode, specify the option /S for SERVER:
  340.  
  341.               zip /S
  342.  
  343. VDE will now wait to receive commands (described below) from the other 
  344. computer.  When you are finished, you can press Escape, ^C, or Ctrl-Break on 
  345. the server end to exit from ZIP.
  346.  
  347.      Alternatively, you can give an instruction to terminate server mode from 
  348. the other ("active") keyboard.  In menu mode, select the choice for "U"nlink 
  349. before quitting.  In command-line mode, specify the option:
  350.  
  351.               /U  = Unlink server after transfer is complete.
  352.  
  353.  
  354. ---------------------------- A. EXCHANGING FILES -----------------------------
  355.  
  356.      When one copy of ZIP is running in server mode, you can transfer files TO 
  357. it from the other (active) keyboard; these will be received on the server end, 
  358. the default directory being either the current directory or another that you 
  359. specify in square brackets when entering server mode:
  360.  
  361.               zip /s[\XFRDIR]  = Server mode, default directory \XFRDIR.
  362.  
  363.      In any event, when you send files to the server, you will be prompted for 
  364. a destination directory (if desired) to override the default on the server 
  365. end.  (Just press ENTER for the default.)  In command-line mode, you can 
  366. specify a directory on the command line in brackets:
  367.  
  368.               zip sendfile /[DESTDIR]
  369.  
  370. (Specify "/[]" if you simply want to avoid the prompt and use the default, for 
  371. example, when running ZIP from a batch file.)
  372.  
  373.      You can also fetch files FROM the server.  In menu mode, just select the 
  374. choice to "F"etch files.  In command-line mode, specify the option:
  375.  
  376.               /F  = Fetch specified files from server.
  377.  
  378.      You must specify the directory with the filenames, if they are not in the 
  379. default directory on the server end.  You will be prompted for a directory to 
  380. receive the files into, unless you specify one in square brackets after the /F 
  381. option in command-line mode:
  382.  
  383.               zip filename /f[DESTDIR]  = Fetch into directory DESTDIR.
  384.  
  385. (Again, specify "/f[]" to avoid the prompt and use the current directory.)  A 
  386. fetch request will not be completed until server mode is detected on the other 
  387. end.
  388.  
  389.  
  390. ------------------ B. VIEWING DIRECTORIES and DELETING FILES -----------------
  391.  
  392.      When ZIP is in menu mode, you will see choices for "D"irectory and 
  393. d"E"lete, offering simple file maintenance without exiting ZIP.COM.
  394.      The directory function provides an alphabetized file listing for your 
  395. reference, and the free space left on the disk.  You will be prompted for the 
  396. files to list.  If you just hit RETURN, ZIP lists all files (*.*) in the 
  397. default directory.
  398.      The delete function prompts for a filename to delete (as always, a 
  399. directory may be included).  Note that only a single filename is accepted; 
  400. wildcards ("*,?") are NOT allowed.  Deletion is immediate; BE CAREFUL.
  401.  
  402.      If the other computer has ZIP running in SERVER MODE, you can also 
  403. request a directory from it, or delete files on it.  In menu mode, when using 
  404. the "D"irectory or d"E"lete commands, simply type a ">" before the filespec to 
  405. indicate that it applies to the server.  This can be done alone, or together 
  406. with a request on the active end:
  407.  
  408.               Directory: \WORK\*.BAK                active alone
  409.               Delete:    >B:\BACKUP\OLD.FIL         server alone
  410.               Directory: \WORK\*.BAK >B:\BACKUP     combined
  411.  
  412.      Alternatively, from the command line, you can specify one of the options:
  413.  
  414.               /D  = Directory from server
  415.               /K  = Kill (delete) file on server
  416.  
  417. /D alone produces all files "*.*", or it can be followed by a filespec in 
  418. brackets, like "[*.bak]".  /K requires a filename in brackets.
  419.  
  420.      A server directory or delete request will not be completed until server 
  421. mode is detected on the other end.
  422.  
  423.  
  424. ============================= 4. USAGE EXAMPLES ==============================
  425.  
  426.                          A. USING ZIP IN BATCH FILES
  427.  
  428.      ZIP is easy to use in batch files.  The "/[DIR]" option allows you to 
  429. bypass user prompts for directory names.  If an error occurs during operation 
  430. in command-line mode, ZIP sets the DOS error code, so that the ERRORLEVEL can 
  431. be tested to determine subsequent action.  Normally 0, the value returned will 
  432. be the sum of whichever of the following errors occurred:
  433.      1 = argument error                   8 = transmission error
  434.      2 = out of memory/too many files    16 = disk error
  435.      4 = connect error/no server        128 = user abort
  436.  
  437.      At times you may need to transfer the entire contents of a sizable disk, 
  438. including several levels of directories.  ZIP is not specifically designed to 
  439. do this: it does not create directories while copying, nor does it look for 
  440. files within subdirectories.  However, it is easy enough to put the receiver 
  441. in Server mode, then run a batch file containing a separate command for each 
  442. desired directory (once corresponding directories exist on both ends):
  443.               zip \work\*.* /t[\work]
  444.               zip \work\ed\*.* /t[\work\ed]  ...
  445.  
  446.  
  447. --------------------- B. EXAMPLES OF COMMAND-LINE SYNTAX ---------------------
  448.  
  449. ----SENDING FILES:
  450.  
  451.  C>zip b:myfile *.doc              sends files B:MYFILE, B:*.DOC
  452.  
  453.  C>zip my.* /2 /p                  sends files C:MY.* over COM2, with
  454.                                  prompts to confirm each file individually
  455.  
  456.  C>zip *.* /n                      sends all files which don't already exist
  457.                                  on receiving directory
  458.  
  459.  C>zip a:chapter.* /et             sends all files A:CHAPTER.* of which an
  460.                                  older version exists on the receiving end
  461. ----RECEIVING FILES:
  462.  
  463.  C:\WORK>zip /r                    receives files into directory C:\WORK
  464.  
  465.  C:\WORK>zip /2 /r[\temp]          receives over COM2 into directory C:\TEMP
  466.  
  467. ----ENTERING SERVER MODE:
  468.  
  469.  C>zip /s2b38                      waits as server to send or receive files
  470.                                  at 38400 bps on COM2
  471.  
  472.  C>zip /s[d:\]                     waits as server, with default directory D:\
  473.  
  474. ----EXCHANGING FILES WITH SERVER:
  475.  
  476.  C>zip *.bak /[]u                  sends files *.BAK to server's default dir
  477.                                  (skipping prompt), then unlinks server 
  478.  
  479.  C>zip *.bak /[b:\recs]            sends files *.BAK to directory B:\RECS
  480.  
  481.  C>zip b:\recs\my.* /f             fetches files MY.* from directory B:\RECS
  482.  
  483.  C>zip b:\recs\my.* /f[\orig]      fetches files MY.* from directory B:\RECS
  484.                                  on server into directory C:\ORIG here
  485.  
  486. ----FILE MANAGEMENT WITH SERVER:
  487.  
  488.  C>zip /d[\work\*.bak]             shows all server's files \WORK\*.BAK
  489.  
  490.  C>zip /k[junk]                    deletes server's file JUNK
  491.  
  492.  
  493. ============================ 5. UTILITY PROGRAMS =============================
  494.  
  495.                          A. USING ZIPDUP TO CLONE ZIP
  496.  
  497.      ZIP comes with a utility program, ZIPDUP, to make it easier to get a copy 
  498. of ZIP.COM onto another computer.  If you can't exchange disks between your 
  499. computers, ZIPDUP gives you a way to duplicate or "clone" ZIP onto the second 
  500. computer over the serial cable.  This is a feature most people need only once, 
  501. so it is not part of ZIP itself.  ZIPDUP will duplicate any version of ZIP 
  502. (indeed, it will duplicate any file, though it's slow and cumbersome compared 
  503. to ZIP itself).  To clone ZIP with ZIPDUP:
  504.  
  505.      1.  Connect the cable to the desired serial port on each computer.  You 
  506. must use COM1 or COM2 only; and the cable must have the DTR lines connected, 
  507. as well as the data lines -- see cabling diagram under "Technical Information" 
  508. below -- or ZIPDUP will not work.  (In this event, you'll need to have a 
  509. telecom program running on both computers, to transfer ZIP.COM via some 
  510. protocol like XMODEM.)
  511.  
  512.      2.  Set up the receiving end:  Make sure the MSDOS utilities DEBUG and 
  513. MODE are available (either in the current directory or in a directory part of 
  514. your PATH statement); you will have to use MODE, and ZIPDUP requires DEBUG.
  515.      Be certain that the last character of your DOS prompt is ">".  (Yes, this 
  516. actually matters!)  If in doubt, type the command:
  517.               PROMPT $P$G
  518.      Then prepare to receive data by typing these two commands:
  519.               MODE COM#:96,N,8,1     ("#" = 1 or 2 only)
  520.               CTTY COM#
  521. The CTTY command gives control to the sending computer, via the COM# port.  
  522. The receiving system will seem to "lock up", ignoring any keyboard input.
  523.  
  524.      3.  Now, on the sending end, to duplicate your copy of ZIP.COM, type:
  525.               ZIPDUP ZIP.COM
  526. (Actually, you can omit the filename if it is "ZIP.COM"; otherwise, type it.)
  527.      You will be asked to specify the COM port (again, 1 or 2 only) that the 
  528. cable is connected to; if the connection can be made, the transfer will 
  529. proceed.  When ZIPDUP is finished, you will find a duplicate copy of ZIP.COM 
  530. in the current directory on the receiving computer.  You can transfer other 
  531. files the same way, but it's easier and faster now to use ZIP itself!
  532.  
  533.  
  534. --------------------- B. USING ZIPCFG TO CHANGE DEFAULTS ---------------------
  535.  
  536.      A second utility, ZIPCFG, allows you to tailor ZIP to your requirements.  
  537. Normally, unless you've instructed it otherwise (via command-line options or 
  538. menu choices), ZIP assumes its built-in "defaults" of 115200 bps, port COM1.  
  539. You can, however, configure your copy of ZIP.COM to change these defaults as 
  540. you like; just type:
  541.               ZIPCFG ZIP.COM
  542. (Actually, you can omit the filename if it is "ZIP.COM"; otherwise, type it.)
  543.  
  544.      To change your defaults, select "Edit" from the ZIPCFG menu, make 
  545. changes, then select "Save"; to restore the original settings, select 
  546. "Restore".  To exit without saving changes, select "Quit".
  547.  
  548.      The "Edit" procedure takes you through a sequence of settings you can 
  549. change.  For the port you may enter simply "COM1" through "COM4", or any other 
  550. specific hexadecimal address required by your hardware ("03F0", etc).  For the 
  551. speed you must choose by letter from the allowed values.
  552.  
  553.      There is also a setting to force 40-column display width.  Normally this 
  554. is set to "No"; you will see "Width=AUTO", and ZIP adapts itself to the 
  555. current video mode (40/80 columns).
  556.  
  557.      Finally, ZIPCFG offers you a choice of color output (via the IBMPC BIOS) 
  558. or standard DOS output.  You might want to select DOS output if color output 
  559. does not display correctly on your video system, or if you will want to 
  560. redirect output from ZIP to a file or device (color output does not redirect).
  561.      If you select color, ZIPCFG displays a palette and offers you a choice of 
  562. text colors.  ZIP uses three different colors: a "message" color, a "hilight" 
  563. color for contrast, and an "active" color (during file transfer activity).  
  564. Each is specified by an "attribute byte" consisting of two hex digits, for a 
  565. background and foreground color.  ("17" = "1", blue background, & "7", white 
  566. text.)  The color digits are:
  567.          0 = BLACK   4 = red       8 = GREY           C = bright red
  568.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  569.          2 = green   6 = brown     A = bright green   E = yellow
  570.          3 = cyan    7 = WHITE     B = bright cyan    F = BRIGHT WHITE
  571.      The palette will include 128 colors from 00-7F.  Use of colors 8-F as 
  572. background (80-FF) is also possible but not recommended, since on most systems 
  573. this produces blinking video.  Some colors may be invisible or indistinguish- 
  574. able on monochrome screens, though all MDA systems can display black, white 
  575. and bright white (which are the default colors), and in some cases grey also.
  576.  
  577.      Please DO NOT distribute modified copies of ZIP.COM; this could confuse 
  578. other users.  They are for your personal use only.  (ZIPCFG includes an option 
  579. to restore the original default values.)
  580.  
  581.  
  582. ========================== 6. TECHNICAL INFORMATION ==========================
  583.  
  584.                             A. GENERAL INFORMATION
  585.  
  586.      Like most communications programs, ZIP does full CRC (Cyclic Redundancy 
  587. checksum) verification on the data to guarantee accurate transfer.  ZIP uses 
  588. its own transfer protocol, which is not compatible with other programs.  Be 
  589. sure to use the SAME version of ZIP on both ends: the transfer protocol may 
  590. have changed.  Do not disturb the cable when ZIP is running, as it will be 
  591. unable to resume its task; you will have to abort the program and try again.
  592.  
  593.      Using any communications software in a multitasking environment often 
  594. requires special precautions.  ZIP, in particular, may need to be given a 
  595. "non-swappable" or "foreground-operation" status, so that other tasks will not 
  596. interfere with its operation.  (Under DesqView, ZIP will disable multitasking 
  597. itself.  Under Windows, you must create a PIF file and give ZIP both 
  598. background and foreground priority.)  You will need at least 96k of memory to 
  599. run ZIP.  You may also need to set a somewhat slower speed for ZIP to work 
  600. reliably.
  601.  
  602.      Do not use ZIP while any serial ports are in use by other software.  In 
  603. particular, potential conflicts exist between COM1 and COM3, and between COM2 
  604. and COM4, because they use the same interrupt vectors.
  605.  
  606.      ZIP works well on the vast majority of systems.  If you experience 
  607. unresolvable conflicts with other memory-resident software, such as background 
  608. processes and disk caches, do not use ZIP when that software is in operation.
  609.  
  610.  
  611. --------------------- B. USING ZIP ON THE HP95LX PALMTOP ---------------------
  612.  
  613.      The Hewlett-Packard 95LX palmtop computer is "nearly" IBM-compatible; ZIP 
  614. will work on it, but there are some special considerations.
  615.      The HP95LX serial port does not support DTR, so ZIPDUP will not work on 
  616. it; instead, to transfer ZIP.COM to the 95LX, you must use the 95LX's internal 
  617. software.  You can purchase the HP Connectivity Pack, which includes a cable, 
  618. or you can buy the serial cable (#HP82222A) separately and use the 95LX COMM 
  619. utility together with any PC communication program to transfer ZIP.COM via 
  620. KERMIT or XMODEM protocol at 19200 bps.
  621.      ZIP automatically detects the 95LX and sets itself for COM1 and 40 
  622. columns.  Thus you can use the same copy of ZIP.COM on your 95LX as on your 
  623. PC; modification with ZIPCFG is not needed.
  624.      ZIP can be run either from the Filer (highlight and press F4, Run) or 
  625. from the DOS system prompt.  ZIP automatically powers up the serial port in 
  626. WIRE mode, and turns it off again upon exit to conserve batteries, so use of 
  627. SERCTL is not necessary.
  628.  
  629.  
  630. ------------------------ C. APPROPRIATE SERIAL CABLES ------------------------
  631.  
  632.      SERIAL NULL MODEM CABLES, in various combinations of 9- and 25-pin 
  633. connectors, are available from a wide variety of sources.  I am told that a 
  634. good source for inexpensive double-headed (both 9 and 25 pin on each end) null 
  635. modem cables, ideal for use with ZIP, is:
  636.               DALCO, 233 Pioneer Blvd, Springboro OH 45066
  637.               (800)445-5342
  638.  
  639.      If you're building or shopping for a cable, you need a "null modem" 
  640. cable, meaning the transmit and receive data lines should be crossed, and the 
  641. signal ground connected straight through.  (The pin numbers depend on whether 
  642. you have a 9-pin DB9 or 25-pin DB25 connector, see figure.)  No other 
  643. connections should be needed; ZIP uses no hardware handshaking lines.  (NOTE: 
  644. ZIPDUP does require the DTR connections between pins 20/4 and 6.)
  645.  
  646.         |--COMPUTER 1--|         |--COMPUTER 2--|
  647.          DB9  or   DB25           DB25  or   DB9
  648.       pin 2 - - - - 3 - - - - - - - 2 - - - - 3   \ transmit &
  649.           3 - - - - 2 - - - - - - - 3 - - - - 2   / receive data
  650.           5 - - - - 7 - - - - - - - 7 - - - - 5   - signal ground
  651.  
  652.       pin 4 - - - - 20  - - - - - - 6 - - - - 6 * \
  653.           6 - - - - 6 - - - - - - - 20  - - - 4 *  \handshaking (optional)
  654.           7 - - - - 4 - - - - - - - 5 - - - - 8    /(* required for ZIPDUP)
  655.           8 - - - - 5 - - - - - - - 4 - - - - 7   /
  656.  
  657. Actually, any serial cable that doesn't work by itself, should work with a 
  658. "null modem adapter" attached.  If possible, use a properly shielded cable; 
  659. high speed transmissions can be especially susceptible to RF interference.
  660.  
  661.  
  662. ----------------------------- D. ERROR MESSAGES ------------------------------
  663.  
  664.      <Argument error>  invalid command-line argument(s).
  665. <Insufficient memory>  ZIP requires a minimum of 94k free RAM.
  666.       <No connection>  no files transferred.  (Bad cable? Wrong version?)
  667.           <No server>  function requires server mode on other computer.
  668.      <Too many files>  global filespec (eg *.*) includes over 1024 files.
  669. <Error reading @file>  @file nested or too large to read.
  670.  <Conflict with NAME>  name conflicts with a directory or read/only file.
  671.       <Cannot delete>  specified file didn't exist, was read/only, etc.
  672.          <Disk error>  trouble reading or writing to disk.  (Disk full?)
  673.             <Aborted>  you pressed Esc/^C/Ctrl-Break.
  674.               <Error>  communication error; or, unrecoverable error.
  675.  
  676.  
  677. ----------------------------- E. VERSION HISTORY -----------------------------
  678.  
  679. ZIP 1.0  (Apr88) - trial release.
  680.     1.1  (Apr88) - improved protocol; wildcard transfers; receive directory
  681.                   option; original file time/date preserved.
  682.     1.2  (May88) - improved error handling; patchable default port also
  683.                   allows use of COM3,4; small bug fixes.
  684.     1.21 (May88) - slower speed options; fixed bug in initializing ports.
  685.     1.22 (Aug88) - improved protocol; fixed bug in deleting temp file.
  686.     1.23 (Jan89) - menu-driven operation; detects disk-full errors.
  687.     1.3  (Apr89) - selective copy options /P,N,E,T; server mode, fetch;
  688.                   file directory; internal improvements.
  689.     1.4  (Sep89) - improved protocol; Delete function; directory shows
  690.                   free space; ZIPCFG utility; small improvements.
  691.     1.41 (Nov89) - DesqView aware; multiple file arguments.
  692.     1.42 (Feb90) - minor improvements; ZIPDUP utility.
  693.     1.43 (Mar90) - simplified multiple argument syntax.
  694.     1.44 (Aug90) - protocol modified for use in network environments.
  695.     1.45 (Mar91) - 4800, 2400bps added; operation at slow speeds improved.
  696.     1.5  (Aug91) - unlink function; new options /B,U,?; sets ERRORLEVEL;
  697.                   recovers from cable disruption; minor improvements.
  698.     1.51 (Jan92) - new "@FLIST" ability; color output; 40-col operation.
  699.     1.52 (Jun92) - new command options /D,K; autoconfigures for HP95LX.
  700.  
  701. (One final note -- this should be obvious but I'll say it anyway: ZIP is not 
  702. related to the new PKZIP series of file compression utilities by Phil Katz.)
  703.  
  704. ====================================[end]=====================================
  705.